@lyfie/luthor-headless 2.6.5 → 2.6.7

package/README.md

@@ -37,6 +37,10 @@ Optional:
 pnpm add highlight.js @emoji-mart/data
 ```
 
+Code-block grammars for common languages
+(`bash`, `json`, `yaml`, `go`, `php`, `ruby`, `csharp`, `kotlin`, `jsx`, `tsx`, `graphql`, `docker`, `toml`, `lua`, `perl`, `r`, `scala`, `dart`) are supported with optional Prism loading.
+By default, `CodeExtension` uses lazy grammar loading and only fetches grammars when code blocks actually use them.
+
 ## Quick Usage
 
 ```tsx

package/dist/index.d.ts

@@ -427,16 +427,16 @@ declare function isLuthorTheme(theme: any): theme is LuthorTheme;
 declare function clearLexicalSelection(editor: LexicalEditor): void;
 declare function resolveLinkNodeKeyFromAnchor(editor: LexicalEditor, anchorEl: HTMLAnchorElement): string | null;
 
-type JsonRecord = Record<string, unknown>;
+type JsonRecord$1 = Record<string, unknown>;
 type JsonDocument = {
-    root: JsonRecord;
+    root: JsonRecord$1;
 };
 type BridgeMode = "markdown" | "html";
 type MetadataEnvelope = {
     id: string;
     type: string;
     path: number[];
-    node: JsonRecord;
+    node: JsonRecord$1;
     fallback: string;
     strategy?: "replace" | "merge";
 };
@@ -457,11 +457,35 @@ declare function appendMetadataEnvelopes(content: string, envelopes: readonly Me
 declare function extractMetadataEnvelopes(content: string): ExtractedMetadataEnvelopes;
 declare function rehydrateDocumentFromEnvelopes(document: JsonDocument, envelopes: readonly MetadataEnvelope[]): JsonDocument;
 
-declare function markdownToJSON(markdown: string): JsonDocument;
-declare function jsonToMarkdown(input: unknown): string;
+type SourceMetadataMode = "preserve" | "none";
+type MarkdownBridgeFlavor = "github" | "luthor" | "lexical-native";
+interface MarkdownBridgeOptions {
+    metadataMode?: SourceMetadataMode;
+    bridgeFlavor?: MarkdownBridgeFlavor;
+}
+declare function markdownToJSON(markdown: string, options?: MarkdownBridgeOptions): JsonDocument;
+declare function jsonToMarkdown(input: unknown, options?: MarkdownBridgeOptions): string;
 
-declare function htmlToJSON(html: string): JsonDocument;
-declare function jsonToHTML(input: unknown): string;
+interface HtmlBridgeOptions {
+    metadataMode?: SourceMetadataMode;
+}
+declare function htmlToJSON(html: string, options?: HtmlBridgeOptions): JsonDocument;
+declare function jsonToHTML(input: unknown, options?: HtmlBridgeOptions): string;
+
+type JsonRecord = Record<string, unknown>;
+type BridgeRepresentabilityContext = {
+    node?: JsonRecord;
+};
+declare const MARKDOWN_SUPPORTED_NODE_TYPES: Set<string>;
+declare const HTML_SUPPORTED_NODE_TYPES: Set<string>;
+declare const MARKDOWN_TEXT_NATIVE_FORMAT_MASK: number;
+declare const MARKDOWN_NATIVE_KEY_MAP: Readonly<Record<string, ReadonlySet<string>>>;
+declare const HTML_NATIVE_KEY_MAP: Readonly<Record<string, ReadonlySet<string>>>;
+declare function isDefaultBridgeValue(_type: string, key: string, value: unknown): boolean;
+declare function isMarkdownRepresentable(type: string, key: string, value: unknown, context?: BridgeRepresentabilityContext): boolean;
+declare function isHTMLRepresentable(type: string, key: string, value: unknown): boolean;
+declare function extractMarkdownMetadataPatch(node: JsonRecord, type: string): JsonRecord | null;
+declare function extractHTMLMetadataPatch(node: JsonRecord, type: string): JsonRecord | null;
 
 /**
  * Commands exposed by text format extensions.
@@ -1418,9 +1442,12 @@ type CodeStateQueries = {
     /** Check whether the current selection is within a code block */
     isInCodeBlock: () => Promise<boolean>;
 };
+type CodeGrammarPreloadMode = "lazy" | "idle" | "eager";
 type CodeExtensionConfig = BaseExtensionConfig & CodeHighlightProviderConfig & {
     syntaxHighlighting?: "auto" | "disabled";
     tokenizer?: CodeTokenizer | null;
+    showLineNumbers?: boolean;
+    grammarPreloadMode?: CodeGrammarPreloadMode;
 };
 /**
  * CodeExtension - Adds code block support for the Lexical editor
@@ -1447,6 +1474,8 @@ type CodeExtensionConfig = BaseExtensionConfig & CodeHighlightProviderConfig & {
 declare class CodeExtension extends BaseExtension<"code", CodeExtensionConfig, CodeCommands, CodeStateQueries, ReactNode[]> {
     private static readonly MAX_CODE_TAB_DEPTH;
     private codeHighlightProviderPromise;
+    private lineNumberTextCache;
+    private appliedLineNumberNodeKeys;
     constructor();
     /**
      * Register the extension with Lexical
@@ -1502,10 +1531,19 @@ declare class CodeExtension extends BaseExtension<"code", CodeExtensionConfig, C
      * @returns Current format or null
      */
     private getCurrentFormatSync;
+    private hasCodeNodeMutations;
     private hasReachedCodeTabLimit;
+    private ensureCodeBlockLineNumbers;
+    private clearCodeBlockLineNumberAttributes;
+    private getCodeBlockLineCount;
+    private getCodeBlockLineNumberText;
 }
 declare const codeExtension: CodeExtension;
 
+declare function getDefaultPopularPrismLanguages(): string[];
+declare function loadPrismLanguages(languages: readonly string[]): Promise<string[]>;
+declare function loadPopularPrismLanguages(): Promise<string[]>;
+
 type CodeIntelligenceCommands = {
     setCodeLanguage: (language: string) => void;
     autoDetectCodeLanguage: () => Promise<string | null>;
@@ -1524,7 +1562,6 @@ type CodeIntelligenceConfig = CodeHighlightProviderConfig & {
     languageOptions?: readonly string[] | CodeLanguageOptionsConfig;
 };
 declare class CodeIntelligenceExtension extends BaseExtension<"codeIntelligence", CodeIntelligenceConfig, CodeIntelligenceCommands, Record<string, never>, ReactNode[]> {
-    private languageOptions;
     constructor();
     register(editor: LexicalEditor): () => void;
     getPlugins(): ReactNode[];
@@ -1917,6 +1954,10 @@ interface ImagePayload {
     alt: string;
     /** Optional caption */
     caption?: string;
+    /** Optional link wrapper URL for badge-style linked images */
+    linkHref?: string;
+    /** Optional link title for badge-style linked images */
+    linkTitle?: string;
     /** Alignment */
     alignment?: Alignment;
     /** CSS class name for styling */
@@ -1957,6 +1998,10 @@ interface SerializedImageNode {
     alt: string;
     /** Optional caption */
     caption?: string;
+    /** Optional link wrapper URL for badge-style linked images */
+    linkHref?: string;
+    /** Optional link title for badge-style linked images */
+    linkTitle?: string;
     /** Alignment */
     alignment: Alignment;
     /** CSS class name */
@@ -2618,4 +2663,4 @@ declare class EnterKeyBehaviorExtension extends BaseExtension<"enterKeyBehavior"
 }
 declare const enterKeyBehaviorExtension: EnterKeyBehaviorExtension;
 
-export { type Alignment, type BaseCommands, BaseExtension, type BaseExtensionConfig, BaseProvider, BlockFormatExtension, BoldExtension, type BridgeMode, CodeExtension, type CodeExtensionConfig, CodeFormatExtension, type CodeHighlightProvider, type CodeHighlightProviderConfig, type CodeIntelligenceCommands, type CodeIntelligenceConfig, CodeIntelligenceExtension, type CodeLanguageOptionsConfig, type CodeLanguageOptionsMode, type CommandPaletteCommands, CommandPaletteExtension, type CommandPaletteItem, type CommandPaletteStateQueries, type ContextMenuCommands, type ContextMenuConfig, ContextMenuExtension, type ContextMenuItem, type ContextMenuStateQueries, DraggableBlockExtension, type DraggableCommands, type DraggableConfig, type DraggableStateQueries, type EditorConfig, type EditorContextType, type EmojiCatalogAdapter, type EmojiCatalogItem, type EmojiCommands, type EmojiConfig, EmojiExtension, type EmojiStateQueries, type EmojiSuggestionState, EnterKeyBehaviorExtension, type Extension, ExtensionCategory, type ExtractCommands, type ExtractNames, type ExtractPlugins, type ExtractStateQueries, type ExtractedMetadataEnvelopes, type FloatingCommands, type FloatingConfig, type FloatingStateQueries, FloatingToolbarExtension, type FontCssLoadStrategy, type FontFamilyConfig, FontFamilyExtension, type FontFamilyOption, type FontSizeConfig, FontSizeExtension, type FontSizeOption, HistoryExtension, HorizontalRuleExtension, IframeEmbedExtension, type ImageCommands, type ImageComponentProps, ImageExtension, type ImageExtensionConfig, type ImagePayload, type ImageStateQueries, ItalicExtension, type JsonDocument, LIGHTWEIGHT_EMOJI_CATALOG, LUTHOR_EDITOR_THEME_TOKENS, type LexicalNodeRegistration, type LineHeightConfig, LineHeightExtension, type LineHeightOption, LinkExtension, ListExtension, type LuthorEditorThemeOverrides, type LuthorEditorThemeToken, type LuthorTheme, type MetadataEnvelope, type PreparedBridgeDocument, RichText, type RichTextComponentProps, type RichTextConfig, type SerializedImageNode, type SlashCommandCommands, type SlashCommandConfig, SlashCommandExtension, type SlashCommandItem, type SlashCommandMenuState, type SlashCommandStateQueries, StrikethroughExtension, SubscriptExtension, SuperscriptExtension, TabIndentExtension, type TableConfig, TableExtension, type TextColorConfig, TextColorExtension, type TextColorOption, TextFormatExtension, type TextHighlightConfig, TextHighlightExtension, type TextHighlightOption, type ToolbarItem, UnderlineExtension, YouTubeEmbedExtension, appendMetadataEnvelopes, blockFormatExtension, boldExtension, clearLexicalSelection, codeExtension, codeFormatExtension, codeIntelligenceExtension, commandPaletteExtension, contextMenuExtension, createCustomNodeExtension, createEditorSystem, createEditorThemeStyleVars, createExtension, defaultLuthorTheme, draggableBlockExtension, emojiExtension, enterKeyBehaviorExtension, extractMetadataEnvelopes, floatingToolbarExtension, fontFamilyExtension, fontSizeExtension, historyExtension, horizontalRuleExtension, htmlToJSON, iframeEmbedExtension, imageExtension, isLuthorTheme, italicExtension, jsonToHTML, jsonToMarkdown, lineHeightExtension, linkExtension, listExtension, markdownToJSON, mergeThemes, prepareDocumentForBridge, rehydrateDocumentFromEnvelopes, resolveLinkNodeKeyFromAnchor, richTextExtension, slashCommandExtension, strikethroughExtension, subscriptExtension, superscriptExtension, tabIndentExtension, tableExtension, textColorExtension, textHighlightExtension, underlineExtension, useBaseEditor, youTubeEmbedExtension };
+export { type Alignment, type BaseCommands, BaseExtension, type BaseExtensionConfig, BaseProvider, BlockFormatExtension, BoldExtension, type BridgeMode, CodeExtension, type CodeExtensionConfig, CodeFormatExtension, type CodeGrammarPreloadMode, type CodeHighlightProvider, type CodeHighlightProviderConfig, type CodeIntelligenceCommands, type CodeIntelligenceConfig, CodeIntelligenceExtension, type CodeLanguageOptionsConfig, type CodeLanguageOptionsMode, type CommandPaletteCommands, CommandPaletteExtension, type CommandPaletteItem, type CommandPaletteStateQueries, type ContextMenuCommands, type ContextMenuConfig, ContextMenuExtension, type ContextMenuItem, type ContextMenuStateQueries, DraggableBlockExtension, type DraggableCommands, type DraggableConfig, type DraggableStateQueries, type EditorConfig, type EditorContextType, type EmojiCatalogAdapter, type EmojiCatalogItem, type EmojiCommands, type EmojiConfig, EmojiExtension, type EmojiStateQueries, type EmojiSuggestionState, EnterKeyBehaviorExtension, type Extension, ExtensionCategory, type ExtractCommands, type ExtractNames, type ExtractPlugins, type ExtractStateQueries, type ExtractedMetadataEnvelopes, type FloatingCommands, type FloatingConfig, type FloatingStateQueries, FloatingToolbarExtension, type FontCssLoadStrategy, type FontFamilyConfig, FontFamilyExtension, type FontFamilyOption, type FontSizeConfig, FontSizeExtension, type FontSizeOption, HTML_NATIVE_KEY_MAP, HTML_SUPPORTED_NODE_TYPES, HistoryExtension, HorizontalRuleExtension, type HtmlBridgeOptions, IframeEmbedExtension, type ImageCommands, type ImageComponentProps, ImageExtension, type ImageExtensionConfig, type ImagePayload, type ImageStateQueries, ItalicExtension, type JsonDocument, LIGHTWEIGHT_EMOJI_CATALOG, LUTHOR_EDITOR_THEME_TOKENS, type LexicalNodeRegistration, type LineHeightConfig, LineHeightExtension, type LineHeightOption, LinkExtension, ListExtension, type LuthorEditorThemeOverrides, type LuthorEditorThemeToken, type LuthorTheme, MARKDOWN_NATIVE_KEY_MAP, MARKDOWN_SUPPORTED_NODE_TYPES, MARKDOWN_TEXT_NATIVE_FORMAT_MASK, type MarkdownBridgeFlavor, type MarkdownBridgeOptions, type MetadataEnvelope, type PreparedBridgeDocument, RichText, type RichTextComponentProps, type RichTextConfig, type SerializedImageNode, type SlashCommandCommands, type SlashCommandConfig, SlashCommandExtension, type SlashCommandItem, type SlashCommandMenuState, type SlashCommandStateQueries, type SourceMetadataMode, StrikethroughExtension, SubscriptExtension, SuperscriptExtension, TabIndentExtension, type TableConfig, TableExtension, type TextColorConfig, TextColorExtension, type TextColorOption, TextFormatExtension, type TextHighlightConfig, TextHighlightExtension, type TextHighlightOption, type ToolbarItem, UnderlineExtension, YouTubeEmbedExtension, appendMetadataEnvelopes, blockFormatExtension, boldExtension, clearLexicalSelection, codeExtension, codeFormatExtension, codeIntelligenceExtension, commandPaletteExtension, contextMenuExtension, createCustomNodeExtension, createEditorSystem, createEditorThemeStyleVars, createExtension, defaultLuthorTheme, draggableBlockExtension, emojiExtension, enterKeyBehaviorExtension, extractHTMLMetadataPatch, extractMarkdownMetadataPatch, extractMetadataEnvelopes, floatingToolbarExtension, fontFamilyExtension, fontSizeExtension, getDefaultPopularPrismLanguages, historyExtension, horizontalRuleExtension, htmlToJSON, iframeEmbedExtension, imageExtension, isDefaultBridgeValue, isHTMLRepresentable, isLuthorTheme, isMarkdownRepresentable, italicExtension, jsonToHTML, jsonToMarkdown, lineHeightExtension, linkExtension, listExtension, loadPopularPrismLanguages, loadPrismLanguages, markdownToJSON, mergeThemes, prepareDocumentForBridge, rehydrateDocumentFromEnvelopes, resolveLinkNodeKeyFromAnchor, richTextExtension, slashCommandExtension, strikethroughExtension, subscriptExtension, superscriptExtension, tabIndentExtension, tableExtension, textColorExtension, textHighlightExtension, underlineExtension, useBaseEditor, youTubeEmbedExtension };